From fe9a8b0ef9194c11552696f3d6f54a4340e181f0 Mon Sep 17 00:00:00 2001
From: Evan Goode <mail@evangoo.de>
Date: Mon, 19 May 2025 21:08:11 +0000
Subject: [PATCH] man: Document `ostree admin unlock --transient`

Signed-off-by: Evan Goode <mail@evangoo.de>
---
 man/ostree-admin-unlock.xml | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/man/ostree-admin-unlock.xml b/man/ostree-admin-unlock.xml
index d499419a..836c77db 100644
--- a/man/ostree-admin-unlock.xml
+++ b/man/ostree-admin-unlock.xml
@@ -83,6 +83,17 @@ License along with this library. If not, see <https://www.gnu.org/licenses/>.
 		you likely want for security hotfixes).
                 </para></listitem>
             </varlistentry>
+            <varlistentry>
+                <term><option>--transient</option></term>
+
+                <listitem><para>If this option is provided, the
+                overlay filesystem will be mounted read-only. It can
+                still be affected by remounting it as read/write in a
+                new mount namespace. For example:</para>
+                <programlisting>ostree admin unlock --transient
+unshare -m -- sh -c 'mount --options-source=disable -o remount,rw /usr &amp;&amp; touch /usr/myfile'</programlisting>
+                </listitem>
+            </varlistentry>
         </variablelist>
     </refsect1>
 </refentry>
-- 
2.30.2